home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / hawaii20.zip / HAWAII.DOC < prev    next >
Text File  |  1993-04-11  |  14KB  |  316 lines
  1.  
  2.                       ╓─────────────────────────────────╖
  3.           ────────────╢  H A W A I I A N   T R I V I A  ╟────────────
  4.                       ╙─────────────────────────────────╜
  5.                                     v2.0
  6.  
  7.                       One of One Step Beyond's Collection
  8.                         of Multi-BBS Doorware programs
  9.                             for systems supporting
  10.                 PCBOARD.SYS, USERS.SYS, DOOR.SYS, CALLINFO.BBS
  11.              USERINFO.DAT, SFDOORS.DAT, DORINFOx.DEF, or CHAIN.TXT
  12.  
  13.                            Written and Supported By:
  14.  
  15.                                 Don Paul Jones
  16.                               84-1043 Hana Street
  17.                                Waianae, HI 96792
  18.  
  19.                              (c) Copyright 1992
  20.                               All Rights Reserved
  21.  
  22.                                  ┌──────────┐
  23.                           ───────┤ WARRANTY ├──────
  24.                                  └──────────┘
  25.  
  26.     This product is provided "as is" without warranty of any kind. The entire
  27.     risk as to the results and performance of the program is assumed by you.
  28.     Futhermore, the author does not warrant, guarantee, or make any other
  29.     representations regarding the use of, or the results of the use of the
  30.     program, and you rely on the program and results solely at your own
  31.     risk. The author cannot and will not accept responsibility for system
  32.     damage,loss of profit, or any other special, consequential or incidental
  33.     damages resulting from the use or inability to use this product.
  34.  
  35.                                  ╓───────────╖
  36.                                  ║ COPYRIGHT ║
  37.                                  ╙───────────╜
  38.  
  39.     HAWAIIAN TRIVIA, Copyright (c) 1992 by Don Jones, is being distributed as
  40.     Shareware. Under this concept you may use the SHAREWARE ( DEMO COPY )
  41.     version for a reasonable period of time for evaluation after which you
  42.     must either register your copy or discontinue usage.
  43.  
  44.                               ╓┬──────────────┬╖
  45.                    ───────────╢│ DISTRIBUTION │╟───────────
  46.                               ╙┴──────────────┴╜
  47.  
  48.     This program is being distributed via the SHAREWARE concept and as such,
  49.     may be copied freely with the following restrictions:
  50.  
  51.                 ■ The program must be supplied in it's original
  52.                   unmodified form, including documentation.
  53.  
  54.                 ■ HAWAIIAN TRIVIA may not be distributed as part of any
  55.                   commercial application or service without the
  56.                   express, written consent of the author.
  57.  
  58.                 ■ Vendors of Shareware/Public Domain software may
  59.                   not distribute this program without the express,
  60.                   written consent of the author, unless said Vendor
  61.                   has been approved by the Association of Shareware
  62.                   Professionals (ASP).
  63.  
  64.                               ╓╥─────────────╥╖
  65.                    ───────────╢║ DESCRIPTION ║╟──────────
  66.                               ╙╨─────────────╨╜
  67.  
  68.     HAWAIIAN TRIVIA is an on-line door game covering the Famous People,
  69.     Famous Places and Famous dates in Hawaiian History.
  70.  
  71.  
  72.                                ╓──────────────╖
  73.                     ───────────╢ REGISTRATION ╟──────────
  74.                                ╙──────────────╜
  75.  
  76.         HAWAIIAN TRIVIA represents many hours of programming and the author
  77.         deserves just compensation for his time, efforts and expertise.
  78.         If you find this program to be of some value and you continue
  79.         to use it on your BBS system, please return the registration
  80.         form provided along with the registration fee. Registration
  81.         entitles you to free upgrades via modem from One Step Beyond BBS.
  82.         Payments should be made in the form of a check or money order
  83.         (do NOT send cash!). Foreign orders must be in U.S. funds drawn
  84.         on a U.S. bank. Registration will remove UNREGISTERED DEMO
  85.         notices as well as activating the "High Scores" display.
  86.  
  87.  
  88.                                ╓────────────╖
  89.                     ───────────╢ HAWAII.CFG ╟───────────
  90.                                ╙────────────╜
  91.  
  92. NOTE: See MISCELLANEOUS NOTES for info on using Environment variables
  93.       in HAWAII.CFG
  94. Configuration file when using USERS.SYS:
  95.    (Also accesses PCBOARD.SYS, PCBOARD.DAT, USERS, and CALLERx)
  96.    C:\PCB\USERS.SYS                    <- Path/filename to USERS.SYS
  97.    One Step Beyond BBS                 <- Name of BBS
  98.    Don                                 <- Sysop's first name
  99.    Jones                               <- Sysop's last Name
  100.  
  101. Configuration file when using PCBOARD.SYS:
  102.    (Also accesses PCBOARD.DAT, USERS, and CALLERx)
  103.    C:\PCB\PCBOARD.SYS                  <- Path/filename to PCBOARD.SYS
  104.    One Step Beyond BBS                 <- Name of BBS
  105.    Don                                 <- Sysop's first name
  106.    Jones                               <- Sysop's last Name
  107.  
  108. Configuration file when using DOOR.SYS:
  109.    C:\PCB\DOOR.SYS                     <- Path/filename to DOOR.SYS
  110.    One Step Beyond BBS                 <- Name of BBS
  111.    Don                                 <- Sysop's first name
  112.    Jones                               <- Sysop's last Name
  113.  
  114. Configuration file when using DORINFO1.DEF:
  115.    C:\BBS\DORINFO1.DEF                 <- Path/filename to DORINFO1.DEF.
  116.    One Step Beyond BBS                 <- Name of BBS
  117.    Don                                 <- Sysop's first name
  118.    Jones                               <- Sysop's last Name
  119.  
  120. Configuration file when using CALLINFO.BBS:
  121.    C:\BBS\CALLINFO.BBS                 <- Path/filename to CALLINFO.BBS
  122.    One Step Beyond BBS                 <- Name of BBS
  123.    Don                                 <- Sysop's first name
  124.    Jones                               <- Sysop's last Name
  125.  
  126. Configuration file when using USERINFO.DAT:
  127.    C:\BBS\USERINFO.DAT                 <- Path/filename to USERINFO.DAT
  128.    One Step Beyond BBS                 <- Name of BBS
  129.    Don                                 <- Sysop's first name
  130.    Jones                               <- Sysop's last Name
  131. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  132.  
  133. Configuration file when using SFDOORS.DAT:
  134.    C:\BBS\SFDOORS.DAT                  <- Path/filename to SFDOORS.DAT
  135.    One Step Beyond BBS                 <- Name of BBS
  136.    Don                                 <- Sysop's first name
  137.    Jones                               <- Sysop's last Name
  138.  
  139. Configuration file when using CHAIN.TXT:
  140.    C:\BBS\CHAIN.TXT                    <- Path/filename to CHAIN.TXT
  141.    One Step Beyond BBS                 <- Name of BBS
  142.    Don                                 <- Sysop's first name
  143.    Jones                               <- Sysop's last Name
  144.  
  145. Configuration file when using GTUSER.BBS:
  146.    C:\BBS\GTUSER.BBS                   <- Path/filename to GTUSER.BBS
  147.    One Step Beyond BBS                 <- Name of BBS
  148.    Don                                 <- Sysop's first name
  149.    Jones                               <- Sysop's last Name
  150.    1                                   <- COM port number (defaults to 1)
  151.    2                                   <- Node number (defaults to 1)
  152.  
  153.  
  154.                       ╓────────────────────────────╖
  155.               ────────╢ HAWAIIAN TRIVIA BATCH FILE ╟─────────
  156.                       ╙────────────────────────────╜
  157.  
  158. This is the batch file whose name is entered in PCBSETUP or the corresponding
  159. utility for your BBS. It should reside in your default BBS directory. Leave 
  160. this AS IS except for changing the paths.
  161.  
  162. ECHO OFF
  163. E:                                      <-- Change to Game Dir Drive
  164. CD\HAWAII                               <-- Path to Game Directory
  165. HAWAIIU HAWAII.CFG                      <-- Command Line
  166. D:                                      <-- Not required if game directory is
  167. CD\PCB                                      on same drive as BBS
  168. BOARD                                   <-- Start your BBS back up
  169.  
  170.                           ╓──────────────────────╖
  171.                  ─────────╢ LOCAL MODE OPERATION ╟──────────
  172.                           ╙──────────────────────╜
  173.  
  174.    To run HAWAIIAN TRIVIA in the local mode, just type:
  175.  
  176.                                    LOCAL
  177.  
  178.  
  179.                               ╓────────────────╖
  180.                               ║ DOOR OPERATION ║
  181.                               ╙────────────────╜
  182.   
  183.   F3    -   Toggles the printer On/Off. Value is passed to PCBoard.
  184.   F4    -   Toggles the Page Bell On/Off. Value is passed to PCBoard.
  185.   F5    -   DOS Shell.  Allows SysOp to exit to DOS from inside a DOOR.
  186.   F7    -   Toggles the Caller Alarm On/Off. Value is passed to PCBoard.
  187.   F8    -   Returns the caller involuntarily to the BBS.
  188.   F9    -   Toggles the local display On/Off. Value is passed to PCBoard.
  189.   F10   -   Activates SysOp CHAT mode within the DOOR.
  190.   ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  191.   HOME  -   HELP key for status line options.
  192.   UP    -   Allows the SysOp to give the caller extra time while in the DOOR.
  193.   DN    -   Allows the SysOp to subtract time from the caller.
  194.  
  195.       NOTE: Time and Level changes are passed to the BBS when using USERS.SYS,
  196.             SFDOORS.DAT, CALLINFO.BBS, USERINFO.DAT or DOOR.SYS.
  197.  
  198.   ALT-N -   SysOp next on toggle. (available only with USERS.SYS or 
  199.             PCBOARD.SYS). Value is passed to PCBoard.
  200.   ALT-X -   Exit to DOS after current caller logs off. (Available only
  201.             with USERS.SYS or PCBOARD.SYS). Value is passed to PCBoard.
  202.  
  203.                             ╓─────────────────────╖
  204.                             ║ MISCELLANEOUS NOTES ║
  205.                             ╙─────────────────────╜
  206.  
  207.  
  208.       ■ The Printer, Page Bell, and Call Alarm toggles as well as any
  209.         changes in caller's Time or Level are written to DOOR.SYS,
  210.         CALLINFO.BBS and SFDOORS.DAT.
  211.  
  212.       ■ PCBoard's Call Waiting screen and USERS are only updated when using
  213.         the USERS.SYS file and not when using PCBOARD.SYS.
  214.  
  215.       ■ You may use Environment variables to pass the Path of your system
  216.         file to HAWAIIAN TRIVIA. HAWAIIAN TRIVIA will recognize the variables
  217.         PCBDRIVE and PCBDIR. Either in your BBS batch file or in
  218.         AUTOEXEC.BAT, place the following two statements:
  219.            SET PCBDRIVE=C:
  220.            SET PCBDIR=\BBS
  221.         Substitute your actual Drive and/or BBS subdirectory.  Then in
  222.         your HTRIVIA.CFG file instead of hard coding it as:
  223.            C:\BBS\DOOR.SYS
  224.         you would use the Environment variables as:
  225.            %PCBDRIVE%%PCBDIR%\DOOR.SYS
  226.         This method allows you to use just one HAWAII.CFG no matter
  227.         which Node is accessing HAWAIIAN TRIVIA.
  228.  
  229.                      ╓──────────────────────────────╖
  230.           ───────────╢       ·U·P·D·A·T·E·S·        ╟────────────
  231.                      ╙──────────────────────────────╜
  232.  
  233.           ■ v1.0 - Initial Release
  234.  
  235.           ■ v1.1 - Optimized the code some.
  236.  
  237.           ■ v1.2 - Added more trivia questions
  238.  
  239.           ■ v1.3 - Changed color of menus
  240.  
  241.           ■ v1.4 - Added capacity to add unlimited questions
  242.  
  243.           ■ v1.5 - Added Q to quit anywhere in the program
  244.  
  245.           ■ v1.6 - Fixed a bug when exiting from a shell, the program
  246.                    would give an invalid selection display.
  247.  
  248.           ■ v1.7 - Removed HotKey function, compiled now with MS Visual
  249.                    Basic for Dos.
  250.  
  251.           ■ v1.8 - Added better "registered to" and closing screen.
  252.                    Added "key" to source to all easy updating and
  253.                    colored "box'ed" questions.
  254.  
  255.           ■ v1.9 - Fixed the "registered to" and closing screen.
  256.  
  257.           ■ v2.0 - Added press "ENTER" to opening, and registered to screens.
  258.  
  259.                      ╓───────────────────────────────╖
  260.           ───────────╢ ·S·P·E·C·I·A·L· ·T·H·A·N·K·S· ╟───────────
  261.                      ╙───────────────────────────────╜
  262.  
  263. HAWAIIAN TRIVIA was compiled using MS VISUAL BASIC FOR DOS in conjunction with
  264. DFRAMEVB by Ted Freeman. I highly recommend the use of DFRAME in your door
  265. writing as Ted Freeman has made DFRAME do alot of the work for you.
  266.  
  267.  
  268.  
  269.         H A W A I I A N   T R I V I A   R E G I S T R A T I O N   F O R M
  270.  
  271.         TO:  Don Paul Jones                             Date___/___/___
  272.              84-1043 Hana Street
  273.              Waianae, Hi 396792
  274.  
  275.  
  276.             (Please use capitalization and punctuation where necessary.)
  277.  
  278.       FROM:  SysOp Name: _______________________________________________ 
  279.  
  280.              BBS Name: _________________________________________________
  281.  
  282.              Address: __________________________________________________ 
  283.  
  284.              City: ______________________ State: __________ ZIP: _______ 
  285.  
  286.              Voice: (   ) _________________ BBS: (   ) _________________
  287.  
  288.              BBS Software: _____________________ BBS Hours: ____________
  289.  
  290.              Baud Rates:________________________ 
  291.  
  292.  
  293.       SOFTWARE                          VERSION                  PRICE 
  294.       --------                          -------                  -----
  295.  
  296.       Hawaiian Trivia ................... 2.0 ................ $10.00 __
  297.       Picture Viewer .................... 1.8 .................$10.00 __
  298.       American Trivia ................... 1.4 .................$10.00 __
  299.       Screen Viewer ..................... 1.3 .................$10.00 __
  300.       Hawaiian Phone Book .(ANSI Version) 1.0 .................  FREE __
  301.       Hawaiian Phone Book .(VGA Version). 1.1 .................  FREE __
  302.       (Current versions as of 03-27-93)
  303.  
  304.       Total .....................................................  -----
  305.  
  306.                                 F E E D B A C K 
  307.                                 ---------------
  308.  
  309.       COMMENTS: _____________________________________________________ 
  310.       _______________________________________________________________ 
  311.       _______________________________________________________________ 
  312.       _______________________________________________________________ 
  313.       _______________________________________________________________ 
  314.  
  315.  
  316.